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INTEQDCfCTIOH 



This document provides a brief introduction to ;tti«- 
:p~%$tem :. : V©r$ion: I\M as implemented: -on the Corvus 
Concept Workstation, It is intended to accompany 
the standard p-System documentation, which- 
includes = the , Operating ■■■System . jteftfcMH». Manual, 
and gqfo^ 

Chapter ■■! .of ■/the' Operating S ystem Refere nce 
Manual • gives.-: an overview of. the system* Personal 
Computing with the UC SP fr-System is an excellent 
general introduction to the use of the system* 

Personal Com puting with the UCSP p-System will 
help you become familiar with the Filer and 
Screen-Oriented Editor. A full description of these 
programs 
Operatl 



ss given in Chapters 4 and 5 of the 
JSvat em ..Reference Manual, 



The use of UCSD Pascal is futher described in the 
manual The UCSP Pascal Handbook by Randy Clark 
and, Stephen Koehler. This manual serves as a 
useful reference guide for users of UCSD Pascal 

and the p-System. 
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On the Corvus Concept Workstation, the p-Systenn 
runs in conjuction with the Corvus Concept 
Operating System (CCOS). The CCOS must be 
booted and operational before the p-System can be 
booted. However, once the p-System is booted, the 
CCOS is used only for low level I/O support. It 
will not be visible while the p-System is running* 



Familiarity with the CCOS is required in order to 
instaB the p-System and create an appropriate 
environment for it. The following Corvus Concept 
documents will be helpful for the installation of the 
p-System: The ' Cor vita. ;,. , L €o , tt c gp t^ v Farso nal 
Wor kst a tion : User \ ' guide ' : m&- ' '' ; ffte " [ Cor y jjjS'' ' ^oneeS t^ 
System 'Managers' OuideT ■■';"..-■ 



The specific CCOS utilities used to install and use 
the p~$yste : m are the Constellation H Volume 
Manager to create p-System volumes on the 
Winchester Disk, the Access Manager to mount 
volumes, the File Manager to copy files from one 
volume to another, and the System Utilities 
Manager to., assign a device driver to the printer. 
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HAHDWARE CONFIGURATIONS 



The p-System as implemented on the Corvus 
Concept Workstation requires the following minimum 
hardware configuration; 

« Corvus Concept Workstation, which includes! 

256K bytes of main memory 
Video Display Unit 
Keyboard 

• Floppy Disk Drive 

• Copvus Winchester Disk Drive 

In addition to this minimum configuration, the 
p-System can support additional main memory and 
peripherals. Since the Corvus Concept Operating 
System is used to provide low level I/O support, 
most peripherals that it supports can be used with 
the p-System. Following is the maximum 

configuration that the p-System will support, with 
an indication of the p-System unit number used to 
access the devices! 

• Up to six disk volumes, which cart be chosen 
from any Corvus volume that has a p-System 
(type 1) directory. The disk volumes are 
assigned p-System device numbers 4, 5 t and 9 
through 12. The RAM disk volume is available 
on systems with 512K bytes of main memory, 

• A console port accessed as CONSOLE; and 
SYSTERM: (p-System devices 1 and 2, 
respectively). 
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• A printer port accessed as PRINTER: (p-System 
device 8), 

• A remote, serial port accessed as REMINi and 
REMOUT: (p-System devices 7 and 8, 
respectively). 
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BRING1KG 0P THE p-SYSTEM 

The following sections describe a step by step 
approach to bringing the p-System up for the first 
time on the Corvus Concept Workstation. The 
important activities described are how to backup 
the system disks* how to install the system, and 
how to boot the system. Also, specific information 
about keyboard use is given. 

There will already be some p-System files present 
on the Corvus Concept Workstation. These existing 
files are meant for executing applications only, and 
should be ignored for the purposes of this manual, 



Sacking Up the System 

The first thing you should do is backup the 
p-System disks. The easiest way to do that is to 
copy the disks onto the Winchester Disk* The 
Winchester Disk copy should then be used as the 
working version and the master disks should be 
saved as a backup copies. 
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The system release consists of two master disks: 
SYSTEM and a compiler disk, either PASCAL or 
FORTRAN, The following steps should be 

followed to copy a master disk to the Winchester 

Disk; 

l< Use the CCOS Constellation H Volume Manager 
to create a volume* It is recommended that 
the volume created for the SYSTEM disk be 
1024 blocks in stea. The volumes created for 
the other disks need only be 512 blocks in 
size. Be certain it is a p-System volume, 

2« Use the CCOS Constellation H Access Manager 
to mount the volume you just created* 

3. Put the master disk to be copied in the floppy 
disk drive. 

4, Use the CCOS Utility File Manager to copy 
the entire contents of the master disk to the 
newly created Winchester Disk volume* Use 
the wild card feature of the file manager to 
eopy the entire contents of the master disk* 
For example, to copy the SYSTEM master disk 
to the Winchester Bisk volume PSYSTEM-, do 
the following after entering the File Managers 

Prasa. the CopyPll* command key 

fin tec /SYSTEM/* < return* 

£nt«z /P5YST2H <r«turn> 

Refer to the Corvus Concept Documentation for 
details on using the CCOS utilities. 
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Throughout this document the names of the 
master disks are used in the instructions for 
setting up the system. You should substitute the 
name of the appropriate backup volume when you 
follow these instructions. The master disks 
should, not be used, because a mistake in setting 
up the system could render some of the master 
disks unusable. 



Booting the p-System 

To boot the p-System. you must first boot the 
CCOS and establish the appropriate environment 
for running the p-System, After that has been 
done, simply press the PSYSTEM function key on 
the primary function key level. This will cause 
the p-System bootstrap program to be loaded and 
executed. When it is complete, the p-System will 
be operational, with its main command line at the 
top of the screen. To terminate the p-System» 
type "H" (for Halt) and you will be returned to 
the CCOS, The following: steps should be 
followed to boot the p-Systenu 

1, If you want to use a printer with the 
p-System, you must assign a device driver to 
the printer and set the printer's parameters. 
This is done using the CCOS system utilities. 
See The Corvu s Ccncept, Personal WorJqsta|lon 

. . €foer •" Outoft " for instructions '"oh the "weot the 
CCSS system utilities. 



0900501:OQA 



p-System for the Corvus Concept Workstation 



2. Type the name of the volume where you 
copied SYSTEM and then the function key 
iSetVol], This is the boot volume, and it must 
at least contain the following files: 

SYSTEM JNTERP 

SYSTBMJ?ASCAL 

SYSTEM-MISOHFO 

3. Press the [PSYSTEM] function key. 

4. All volumes that you have the option to mount 
are displayed on the screen. If there is 
enough memory, the EAM disk option will be 
available. If you did not mount the PRINTER: 
driver, there will be a warning message, If 
you have access to more than five p~System 
volumes, you will be prompted for which 
volumes to mount. If you have access to five 
or less volumes, all volumes will be mounted. 
If you make a mistake during this process, 
press the <esc> key and you will exit to the 
CCOS Dispatcher. 

If you have a system with 512K bytes of main 
memory, one of the six p-System units will be 
a HAM disk volume* In this case* you may 
enter up to five other volumes. The' EAM 
disk volume will toe assigned the p-System unit 
number five. The RAM disk volume acts as a 
normal disk drive, but it is much faster 
because It is. In memory and it is temporary, 
e*g., it will be erased upon leaving the 
p-System* 
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5, The p-System bootstrap process will now begin. 
The system will be loaded into memory and 
initialized. When the p-System comes up, it 
will use the character set and screen window 
that was in effect at the start of the boot 
process/ If you wish to change either of 
these, use the CCOS System Manager Utility 
or Window Manager Utility to do so. 



Keyboard Considerations 



There are several keys and control characters 
which are frequently used when running the 
p-System. The following table identifies the 
special keys and control characters and their 
function on the Corvus Concepts 

COttTBOL-C - StX, Editor accept, and CONSOLS end of fill* 

COMTROL-F « Flush 

CQNtfSOL~R * alpha- lock 

COHTHOL-S * Stop CONSOLE output 

GQBWROL-Q * !bsuh»« COKSOtfi ' Output 

COMTSOb-2 * editor character insect key 

CONTROL-X * Editor oharactet delete Kay 

BSCA#E * System sscapa leay (rtuist be pressed twice) 

With the exception of stop and resume CONSOLE 
output, the p-System 's Setup utility may be used 
to change the keys used to perform the above 
functions. See Chapter 5 of the Operating 
System Re ference Manual on using the Setup 
utility. 
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Extended Memory and Setup Factors 



The p-$ystem, as shipped on the release, disks, is 
configured as an extended memory system. When 
it is booted, the system determines how much 
memory is available and seta the code pool base 
and code pool size accordingly. The Setup utility 
allows you to specify whether extended memory 
is to be used* If you desire to run the p-System 
as a non-e&tended memory system with an 
internal code pool* use the Setup utility to set 
the system parameter HAS EXTENDED MEMORY 
to FALSE. The Setup utility also lets you 
specify values for the code pool size and base 
address. However, the Corvus Concept 

implementation of the p-System ignores these 
values because it dynamically determines the best 
values for them. 
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FLOATING POINT CONFIGURATION 

The system, as it is configured initially, supports 
4-word floating point (real) numbers* It may be 
configured . to support 2-word . or 4-word real 
numbers or no real numbers at all. Four- word real 
numbers provide the most precision but also require 
the most data space for their representation. 
Two-word real numbers may be desired for 
applications where high precision is not required 
and program data 3pace is in short supply. A 
system with no real number support at all may be 
configured. 

To change the real number support, the following 
steps must be taken: 

1. Install the correct version of REALOPS in the 
operating system file (SYSTEM.PASCAL)? and 

2. Select the p-machine emulator that provides the 
desired real number support and copy it to the 
boot disk as SYSTEMS NTERP. 

These steps should only be done after the master 
disks have been backed up, A mistake in these 
steps could render them unusable. 
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Prior to changing the real number support, you 
should decide which level of reel number support 
you want. If you choose 2-word reals* the files 
REALOPS2.CODE and 2WORD.WTERP should be 
used in the following steps* If you choose 4-word 
reals,, the files REALOPS4.CODE and 
4WORD4NTERP should be used In the following 
steps* If you choose no real number support at all, 
the file OWORDJKTERp should be used in the 
following steps. Since thtf REALOPS unit of the 
operating system is not used in a no- reals system, 
you need not change the operating system if you 
select this level of real number support. 



To install REALOPS in the operating system, the 
Library utility is used. You should make sure that 
there is enough room on the boot disk to create a 
new system (approximately 125 blocks). The 

following steps should be followed* 

1. Set the current volume to PSYSTEM (the volume 
that is a copy of the SYSTEM disk) and boot 
the p-System. 



2. Execute LIBRARY. 

utility. 



This invokes the Library 



3. Respond "NEWSYS.CODE" to the prompt for the 
output file name, 

4. Respond * SYSTEM. PASCAL" to the prompt for 
the input file name. 



12 
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5, Selectively copy all units and segments, except 
the REALOPS unit, from the input file to the 
output file. This is done by entering "$" at the 
Library utility's command line then responding 
"if" to the prompt to copy each unit or segment 
and "N" to the prompt to copy the REALOPS 

. . unit. . 

6* Enter "N" to get a new input file. Then enter 
the name of the REALOPS file you selected 
(prefixed with "SYSTEM:", i.e., 
"SYSTEM^REALOPSa.CODE"), 

7. Enter "T" to Inhibit the copying of interface 
text to the output file. 

S. Enter tt E" to copy every segment. 

9. Enter "Q" to quit the Library utility. 

10. Enter <return> to the prompt for a copyright 
notice. 

11. Execute the Filer by typing "F" from the main 
command line. 

12. Enter n C n to use the C{hange command of the 
Filer. 

13. Respond "KEWSYS.CODE" to the prompt 
requesting the name of the file to change. 

14. Respond "SYSTEM. PASCAL" to the prompt 
requesting the new name of the file. 
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15. Respond "Y* to the question "DELETE OLD 
SYSTEM.PASCAL?". 



There will now be a new operating system in the 
boot volume that contains support for real numbers 
and transcendental functions. 



To install a new p-maehine emulator with the 
correct real number module, the following steps 
should be performed: 

U Execute the Filer by typing n F B from the main 
command line, 

2. Enter "TV to use the transfer command. 

3« When the Filer prompts for the name of the file 
to transfer, enter the name of the p-ma chine 
emulator that contains the desired real number 
support prefixed with "SYSTEM*" (i,e,» 
SYSTEM s4WORD.rNTEEP, 
SYSTEMS WORD. I NTERP, or 

SYSTEMjOWORDJNTEBP). 

4, When the Filer prompts for the name of the 
destination file, enter "SYSTEMJNTEEP". 
Respond *Y™ to. the question "DELETE OLD 
SYSTEM JNTERP?", 

There' will now be a new p-machine emulator on 
the boot volume that contains the desired real 
number support, 

Reboot the system to make the new real number 
system operational. 



14 
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TURTLEGRAFH1CS CONFIGURATION 

The Turtlegraphics routines as initially shipped with 
the system use 4~word real numbers* If you change 
the real number support of the system, as described 
m the "Floating Point Configuration" section, you 
must also change the Turtlegraphics routines , If 
you use REALOPS2.CODE, you must use 
TT7RTLE2.CODE, and REALOPS4XODE uses 
TURTLE4.C0DE. To install Turtlegraphics in 

SYSTEM.L1BRARY, the Library utility is used. You 
should make sure there is enough room on the boot 
volume to create a new file {approximately 35 
blocks). The following steps should be followed: 

1. Set the current volume to PSYSTEM (the volume 
that is a copy of SYSTEM disk). 



2«- Execute Library, 
utility. 



This invokes the Library 



3. Respond "NEWUB.CODE" to the prompt for the 
output file name, 

4. Respond "SYSTEM. LIBRARY" to the prompt for 
the input file name, 

5. Selectively copy all units and segments, except 
the TURTLE GR unit, from the input file to the 
output file. This is done by entering "S" at the 
Library utility's command line then responding 
"Y" to the prompt to copy each unit or segment 
and "N" to the prompt to copy the TURTLEGR 
unit. 
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$. Enter "N* 1 to get a new input file. Then enter 
the name of the Turtlegraphies file you selected 
(i.e», w TURTLE2.CODB w or tt TURTLE4.CODE"). 

7. Enter "E* to copy every segment, 

ft. Enter tt Q w to quit the Library utility* 

9. Enter <return> to the prompt for a copyright 
notice. 

10. Escecute the Filer by typing W F M from the main 
command line.. 

11. Enter W C" to use the COiange command of the 
Filer* 

12. Respond "NEWL1B.CODE" to the prompt 
requesting the name of the file to change* 

1». Respond "SYSTEM.UBRARY* to the prompt 
revesting the new name of the file. 

14. Respond "Y* to the question "DELETE OLD 
SYSTEM.LIBRARY?". 



The correct Turtlegraphics routines will now be in 
the file »SYSTEMJiBRARY w . 



Refer to the Program Development Reference 
Manua l for directions on use of Turtlegraphics* 
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MATIVE CODE PROCEDURES 



This section describes the conventions for writing 
assembly s>rocedures to be called from Pascal or 
another high-level language. This section is only 
important if you are writing assembly code. 



An assembly procedure is called via a JSR 
instruction, so it should expect a double word 
return address on the stack when it is called. 
Return to the host using an RTS instruction. 

Registers A0-A2 and D0-D7 are available for use. 
Registers A3-A7 must be restored to the values at 
call-time if they are used. 

Since pointers within the p-machine are byte 
offsets from a base register (A8), .PUBLIC 
references to Pascal variables will generate an 
offset, not the actual address, of the variable. To 
access an external variable, use this offset as a 
displacement from A6. For examples 



AD1JQ.W 



tl,ASCCA6) 



will increment the Pascal variable ABC, 
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A variable parameter is a p-machine pointer to the 
parameter, so it is also accessed as above* For 
example, a variable parameter may be accessed as 
follows: 



MOVEQ #0,D7 
MGVE.W 4 <3F),D7 
ADDQ.W #1,0 <M»,D7.1> 



j cleat 'D7,X 

; io&d the polntar (p&ramater] 

i lnc-x«n«flt the variabl* 



References to variables. In other assembly 
procedures (via a ,RE.F> may be accessed as above, 
provided the segment the procedures are in is 
located in the data area (i*e« t it is not a 
EELPROC)* 

Here is a list of the register values available to 
the assembly procedure on entry. 

A2 - base of current segment 

A3 - base of PME 

A4 - p-machine program counter 

A6 - pointer to data area 

A 7 ~ stack pointer 

The symbol JNTERP (used to access items in the 
PME) is ignored* Instead, accesses should be made 
relative to A3 (the base of the p~machine)« The 

following entry point is available to the assembly 
code programmer: 



Rout in* 
X8QERK 



Offset Puraaeters 

04B DO.W » execution actor numb«r 
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XEQEHK may be used to cause an execution error 
to be recognissed from assembly language, XEQERR 
should be jumped to; not called. Before jumping to 
XEQEEB, the stack should be clear of all 
parameters (including the return word), and ail 
registers should be restored. This routine is 
nor rnally used for system work. 
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DISK FILB CONFIOtJEATIOKS 



The standard system is shipped to you on the 
SYSTEM disk. In the standard shipment, you will 
also get a Pascal or FOB.TRAH J -77 compiler disk 
named PASCAL or FORTRAN, respectively. There 
are additional disks which are not part of the 
standard shipment but which can be purchased 
separately. They are PASCAL, FORTRAN, BASIC, 
ASM, and SFTCH. Following is a list of the Hies 
that are on each of these disks. 



SYSTEMj {Standard Disk) 

SYSTEMJNTEBP 
SYSTEMJPASCAL 
SYSTEM.M1SCINFO 
SYSTEM..FILER 
SYSTEMJBDITOR 
SYSTEM.LIBRARY 
TURTLE&CODE 
T0RTLE4.CODE 
SYSTEMJPONT 
LIBRARY.CODE 
DISK8IZE.CODE 
ABSWHITE.CODE 
COPYDirPDIR.CODE 
MARKBUPDffi.CODE 

QUICKSTART.CODE 
REALCGNV.CODE 
RECOVER.CODE 
REMTALK.CODE 
SETOP.CODE 
■ REALOPS2XOBE 
REAL0PS4,C0DE 
0WOR.DJNTERP 
2W0RDJNTERF 
4W0RDJNTERP 
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DECODE.CODE 

XREF.COOE 

COMPRESS.CODE 

K£RNEL,CODE 

COMMANDIO*CODE 

SCREENOPS.CODE 

DIRJNFO.CODE 

FtLEJNFOXODE 

SYSJNFO.CODE 
W1L0.CODE 

saoooJBRRoas 

68000.NCGXODB 

68000.OPCODES 

CHKStfMOPS.CODE 

ERRORHANDL.CODE 

PATCE.CODE 

PEDGEK.CODE 

SYSTEM. ASSMBLER 

SYSTEM..LINKER 

PASCAL! (Optional Disk} 

PASCAL-COMPILER 
SYSTEM .SYNTAX 

BASIC; {Optional Disk} 

BASJC.R4.C0DE 
BASIC;R2,C0DE 
BLIB J14.C0DE 

BL1B«R2*C0DE 

FORTRAN: {Optional Disk} 

FORTRAN JU.CODE 
FORTRAN J&4.C0DE 
F0RTLIBJ&2X0DE 
F0RTLIBJ14,C0DE 
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ASMt 

11.ERRORS 

Z80.ERRORS 

85G0»£RRORS 

880ej2RROR$ 

808G.ERRORS 

9900JEHRORS 

1 1 #0 POO DISS 

ZSOXPCODES 

6SG0XPC0DES 

68G9XPCODES 

8080:OPCODES 

eeOOXPCODES 

A5M68G9XODE 

ASMSQ8GX0DE 

A5M99D0.CODE 

ASM11.C0DE 

ASMZ80XODE 

ASM6500.CODE 

8086.ERBORS 

8O86XPC0DES 

8087JPOPS 

ASM8086JV.CODE 

68000.ERRORS 

68DQ0XPCODES 

A5IVI68O0GXODE 



{Optional Disk containing 
assemoters} 
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SFTCRJ 
., TE$T8A*CpDE 
,TE$T$CXODE 

■ 'TE$T6DXQDE 
. . TEST8EX0DE 

TEST6BX0DE 

TEST8EX0DE. 

TEST13AX0DE 

TEST13EX0DE 

TEST13C.C0DE 

TESTX3DX0DE 

TESTt3E.C0DE 

TEST14AXQDE 

TEST14BXGDE 

TEST14CXO0E 

TEST14DX0DE 

TEST14EX0DE 

TEST15AX0DE 

TEBTX5B.C0DE 

TBSTX5CXQDE 

■"TE8TI5D.COOE 

TESTX5EX0DE 

AQtnZXODE 

QUIZ0A,TEXT 

QUIZ0B,TEXT 

Q0IZ8CTEXT 

Q01Z6D.TEXT 

Q0IZ8E.TEXT 

QUIZ8F.TBXT 

■ QUIZ13A.TEXT 
QtfelSH.tEXT 
Q0I213C.TEX'T 
QUIZ1&D.TEXT 
QUIZ13E.TEXT 
QUIZHA.TEXT 
QOIZUB^TEXT 
QUXZ14C.TEXT 
QUIZ14D.TEXT 
QUIZ14E.TEXT 



{Optional Disk 
containing SofTeachl 
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Q ; Ul2il5A..TEXT 
Q : mZlSB:,tEXT 

^IJiZ I 5 S*TE XT 
Q-tJIZlJDATA ■ 
#mfc2jDATA 

QiUtiz:a.£)ATA 

QtJl£4*DA.TA 

QETlt'SJOAtA 

QOTXtJATA ■ 

QUIZBJDATA 

QUimMTA. 

QtftZllbjDATA 

QUim.DATA 

CSKRliBiTEXT 

ALTl$C*c6bfi . 

ALT154CCODE 



the ;; : remainder of this section discusses some 
strategies for configuring files on volumes. You 
may - :i want: .'to , experiment with various ways to 
organise tfee system flies on the volumes you use. 
This- section^ describes. -the constraints: that must be 
met, and:malce$ : afew -useful suggestions. 
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There are certain system files which must be c 
the boot volume. Other system files may be piac* 
on other volumes* nr a standard configuration, tr 
following system fEes (if they exist) must be on tfc 
boot volume: 



SYST1M4KTERP 

SYSTEMS ASCAL 

SYSTSM,MISCm^O 

SYSTE&ULiBRARY 

SYST2M.WRiC.fEXT 

SYOTBM.WBK.CODE 

SYSTEM,$TARTUt> 

SYSTEM^SYNTAX 

SYSTSM.FONT 



Of these files, the ones which may cause spae 
difficulties are the workfiles (SYSTEM.WRK.TM 
and SYSTEM*WRJt.CQD£). They are constant!' 
being modified, expanded, created, and destroyed a 
new versions of a program or other text ar 
produced* Since they must be stored on the boo 
volume, it is critical to leave as much room fa 
them as possible. It is recom mended that yo 
allocate 1024 blocks for the volumes you creat 
that are to be used as boot volumes, If tnis can* 
be done, you can create extra work space on yo* 
boot volumes by moving the system files which a 
not have to be on the boot volure< 
(SY5TEM.COMPILER, SYSTEM. EDITOR, and 9 
forth) to another volume. 
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